GetCharacters
Returns the ApiCharacters object that represents a range of characters within the object text. Use the ApiCharacters object to format characters within a text string.
Syntax
expression.GetCharacters(Start, Length);
expression - A variable that represents a ApiRange class.
Parameters
| Name | Required/Optional | Data type | Default | Description |
|---|---|---|---|---|
| Start | Required | number | The first character to be returned. If this argument is either 1 or omitted, this property returns a range of characters starting with the first character. | |
| Length | Required | number | The number of characters to be returned. If this argument is omitted, this property returns the remainder of the string (everything after the Start character). |
Returns
Example
This example shows how to get the ApiCharacters object that represents a range of characters within the object text.
var oWorksheet = Api.GetActiveSheet();
var oRange = oWorksheet.GetRange("B1");
oRange.SetValue("This is just a sample text.");
var oCharacters = oRange.GetCharacters(9, 4);
var oFont = oCharacters.GetFont();
oFont.SetBold(true);